home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / ronscall.zip / RONSCALL.DOC < prev    next >
Text File  |  1992-09-18  |  11KB  |  419 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                         RonsCALL
  24.  
  25.                               A WILDCAT! DISPLAY GENERATOR
  26.  
  27.                                       Version 3.36
  28.                                    September 18, 1992
  29.  
  30.  
  31.                         (C) COPYRIGHT 1991 - All Rights Reserved
  32.  
  33.                                            by
  34.  
  35.                                      Ron van Rossum
  36.                                     Adenauerlaan 84
  37.                                   3137 JA  Vlaardingen
  38.                                     The Netherlands
  39.  
  40.                                   Data *31-10-4752961
  41.  
  42.  
  43.  
  44.  
  45.           TABLE OF CONTENTS
  46.  
  47.  
  48.  
  49.           INTODUCTION
  50.  
  51.                Features . . . . . . . . . . . . . . . . . . . . . . . 2
  52.                System requirements  . . . . . . . . . . . . . . . . . 2
  53.                Licensing  . . . . . . . . . . . . . . . . . . . . . . 2
  54.                Warrenty . . . . . . . . . . . . . . . . . . . . . . . 2
  55.                Support  . . . . . . . . . . . . . . . . . . . . . . . 3
  56.  
  57.           GETTING STARTED
  58.  
  59.                Files included . . . . . . . . . . . . . . . . . . . . 4
  60.                Runtime Files  . . . . . . . . . . . . . . . . . . . . 4
  61.                Installation . . . . . . . . . . . . . . . . . . . . . 4
  62.                Environment variables  . . . . . . . . . . . . . . . . 5
  63.  
  64.           RUNNING THE PROGRAM
  65.  
  66.                Call processing event  . . . . . . . . . . . . . . . . 6
  67.                Command line options . . . . . . . . . . . . . . . . . 6
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.           -------------------------------------------------------------------
  103.           McBAUD! Productions - RONSCALL.DOC                           Page 1
  104.  
  105.  
  106.  
  107.  
  108.           INTRODUCTION
  109.  
  110.  
  111.  
  112.           FEATURES
  113.  
  114.           RonsCALL is a fast and powerful tool for creating an attractive and
  115.           colorful welcomescreen (or bulletin) with todays callers.
  116.  
  117.           RonsCALL offers many advanced features:
  118.  
  119.             ■  Full color screen display of progress.
  120.             ■  WILDCAT! Multi-node support.
  121.             ■  SPEED!  -- All information  about the  last caller  is derived
  122.                from DOOR.SYS, no need to scan the entire ACTIVITY log.
  123.             ■  Runtime  parameters are  passed on  the command  line  and all
  124.                information needed  about the System is taken from  WILDCAT!'s
  125.                Configuration Files.
  126.             ■  Include/exclude local logons in the display.
  127.             ■  Include/exclude Sysop logons in the display.
  128.             ■  Exclude specific Profiles from the display.
  129.             ■  Exclude specific Users from the display.
  130.             ■  Exclude specific Nodes from the display.
  131.             ■  Quiet mode for even more speed.
  132.  
  133.  
  134.           SYSTEM REQUIREMENTS
  135.  
  136.           RonsCALL does  not have  any special  hardware requirements  beyond
  137.           what is needed to setup and run your BBS software.  To run RonsCALL
  138.           you need the WILDCAT! v3.0 type of BBS software.
  139.  
  140.  
  141.           LICENSING
  142.  
  143.           The RonsCALL program  and its accompanying documentation  have been
  144.           released as  shareware.  This gives you the  chance to evaluate the
  145.           performance of  the software for a 30 day  period.  If you continue
  146.           to  use  this  product beyond  this  period,  you  are  expected to
  147.           register and pay  for the program.  You  may not use RonsCALL  in a
  148.           business or institutional  environment without registering  it, and
  149.           each registered  copy of RonsCALL is  licensed for use at  a SINGLE
  150.           site only.
  151.  
  152.  
  153.           WARRENTY
  154.  
  155.           The  author  specifically disclaims  all  warrenties,  expressed or
  156.           implied,  including  but  not  limited  to  implied  warrenties  of
  157.           merchantability and fitness for a paticular purpose and the program
  158.           license  granted   herein  in  particular,   and  without  limiting
  159.           operation of  the program  license with  respect to  any particular
  160.           application,  use, or  purpose.  In  no event  shall the  author be
  161.           liable for any loss of profit,  lost savings, commercial damage, or
  162.  
  163.  
  164.  
  165.           -------------------------------------------------------------------
  166.           McBAUD! Productions - RONSCALL.DOC                           Page 2
  167.  
  168.  
  169.  
  170.  
  171.           other incidental or concequential damages arising out of the use or
  172.           inability to use RonsCALL even if the author, Ron van Rossum, or an
  173.           authorized  distributor  of the  product  has been  advised  of the
  174.           possibility of such damages, or for any claim by any other party.
  175.  
  176.  
  177.           SUPPORT
  178.  
  179.           Product support is available through several channels.   To contact
  180.           the   author  with  questions,  suggestions,   problems,  or  other
  181.           comments,
  182.  
  183.  
  184.             ■  Call McBAUD! BBS at *31-10-4752961 and  leave a message to RON
  185.                VAN ROSSUM in the "MAIN BOARD" conference.
  186.  
  187.             ■  Leave a message to RON  VAN.ROSSUM in the WILDCAT!  conference
  188.                on ILink:
  189.  
  190.             ■  Drop a note via Mail to:
  191.  
  192.                Ron van Rossum
  193.                Adenauerlaan 84
  194.                3137 JA  Vlaardingen
  195.                The Netherlands
  196.  
  197.  
  198.           The  author  offers  limited  support   to  unregistered  users  of
  199.           RonsCALL.  If you have  a problem installing or using the software,
  200.           and  you have read  this entire  User's Manual (please  do read the
  201.           manual  before  requesting help),  then feel  free to  request help
  202.           through either  of the channels  mentioned above.   I will  make an
  203.           attampt to  answer all  mail received,  but  please be  aware  that
  204.           registered users have first priority for support.
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.           -------------------------------------------------------------------
  229.           McBAUD! Productions - RONSCALL.DOC                           Page 3
  230.  
  231.  
  232.  
  233.  
  234.           GETTING STARTED
  235.  
  236.  
  237.  
  238.           FILES INCLUDED
  239.  
  240.           The RonsCALL installation kit is distributed in a single compressed
  241.           library file, containing the following files:
  242.  
  243.  
  244.                RONSCALL.EXE   The executable file.
  245.  
  246.                RONSCALL.NOT   Optional File containing the profiles/Usernames
  247.                               and/or Node-id's to exclude from the Display.
  248.  
  249.                RONSCALL.KEY   REGISTERED VERSIONS ONLY, removes the 10 second
  250.                               delay  at   the  end,  and  reveals   two  more
  251.                               commandline switches.
  252.  
  253.                RONSCALL.DOC   This documentation file.
  254.  
  255.                POSTCALL.BAT   Sample batch file for running RonsCALL.
  256.  
  257.  
  258.           RUNTIME FILES
  259.  
  260. |         RonsCALL maintains a small sized  database in the same directory as
  261. |         where the User Database is kept, to record callers information:
  262.  
  263.  
  264.                RONSCALL.DAT   Todays  callers database, the size of this file
  265.                               grows to the maximum size  of 12 + (#calls-per-
  266.                               day * 77).
  267.  
  268.  
  269.           INSTALLATION
  270.  
  271.           The installation steps are simple;
  272.  
  273.             ■  Copy RONSCALL.EXE to any directory in your DOS path.
  274.  
  275.             ■  Copy RONSCALL.KEY (REGISTERED VERSIONS ONLY!) to your WILDCAT!
  276.                Home directory.
  277.  
  278.             ■  Copy POSTCALL.BAT to your WILDCAT! Home directory.
  279.  
  280.             ■  Optionaly copy  RONSCALL.NOT to  your WILDCAT! Home  directory
  281.                (This File needs editing, see the example for details).
  282.  
  283.  
  284.           WILDCAT!'s Home Directory is the one containing MAKEWILD.DAT.
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.           -------------------------------------------------------------------
  292.           McBAUD! Productions - RONSCALL.DOC                           Page 4
  293.  
  294.  
  295.  
  296.  
  297.           ENVIRONMENT VARIABLES
  298.  
  299.           RonsCALL  fully supports  WILDCAT!'s environment variables,  but in
  300.           addition it recognises the variable RONSKEY.
  301.  
  302.           If  you,  for  example,  put  your  RONSCALL.KEY  in the  directory
  303.           "C:\REGKEYS", you  need  to  tell  RonsCALL  so  by  including  the
  304.           following statement in your AUTOEXEC.BAT:
  305.  
  306.                Set RONSKEY=C:\REGKEYS
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.           -------------------------------------------------------------------
  355.           McBAUD! Productions - RONSCALL.DOC                           Page 5
  356.  
  357.  
  358.  
  359.  
  360.           RUNNING THE PROGRAM
  361.  
  362.  
  363.  
  364.           CALL PROCESSING EVENT
  365.  
  366.           RonsCALL  should  be  run after  each  and  every  call.   WILDCAT!
  367.           automaticly  executes  its  Call  Processing   Event  if  the  File
  368.           POSTCALL.RUN  exists  in   a  NODE  WORK  directory   or  the  file
  369.           POSTCALL.BAT  exists  in the  WILDCAT!  HOME directory.    For more
  370.           information see your SYSOP Guide, chapter 7 - Features in depth.
  371.  
  372.  
  373.           COMMAND LINE OPTIONS
  374.  
  375.           RONSCALL display [/B|/D] [-C:nnnn] [-K] [-L] [-P] [-Q] [-R] [-S]
  376.  
  377.           ?         This will cause RonsCALL to display a help screen showing
  378.                     the different command line options.
  379.  
  380.           display   This is the  base-name of the  outputfile to write.   The
  381.                     suffix  .BBS is  added  automaticly.  The name  should be
  382.                     a valid DOS name.
  383.  
  384.           /B        This will  tell  RonsCALL to  write the  display file  in
  385.                     WILDCAT!'s [B]ulletin  directory.    This  switch  cannot
  386.                     exist together with the following switch:
  387.  
  388.           /D        This  will  tell RonsCALL  to write  the display  file in
  389.                     WILDCAT!'s  [D]isplay directory.   This  is  the programs
  390.                     default if no /B or /D is included.
  391.  
  392.           -C:nnnn   This  tells  RonsCALL   which  [C]onference  to  use   in
  393.                     determining the Display-  or Bulletin Path.   The default
  394.                     conference is 0 (zero). (REGISTERED VERSIONS ONLY!)
  395.  
  396.           -K        This makes RonsCALL [K]ill DOOR.SYS after processing.
  397.  
  398.           -L        This is used  to include  [L]ocal logins to  the list  of
  399.                     callers.  Local logons are by default NOT included.
  400.  
  401.           -P        This makes RonsCALL [P]ost "DROPPED  CARRIER" in place of
  402.                     the Users from-part in case of Users dropping carrier.
  403.  
  404.           -Q        This tells RonsCALL to run in [Q]uit mode.  Only a little
  405.                     propeller  is  showing   program  activity.   (REGISTERED
  406.                     VERSIONS ONLY!)
  407.  
  408.           -R        This is used to [R]estrict the display file to callers to
  409.                     the current node.
  410.  
  411.           -S        This tells RonsCALL to include calls of the  person who's
  412.                     name  is listed  as  SYSOP in  MAKEWILD  in the  display.
  413.                     SYSOP logons are by default not included.
  414.  
  415.  
  416.  
  417.           -------------------------------------------------------------------
  418.           McBAUD! Productions - RONSCALL.DOC                           Page 6
  419.